home *** CD-ROM | disk | FTP | other *** search
/ Shareware Extravaganza - Disc 1 / ShareWare Extravaganza 1 of 4 (The Ultimate Shareware Company).iso / grprogs / vgacad25.exe / VGACAP.DOC < prev    next >
Text File  |  1991-05-12  |  20KB  |  475 lines
  1.        VGACAP (c) Copr. 1987-91 Lawrence Gozum & Marvin Gozum
  2.        ───────────────────────────────────────────────────────
  3.  
  4.                                  User Manual
  5.  
  6.     DISCLAIMER
  7.  
  8.     This product is distributed AS IS.  The authors specifically disclaim
  9.     all warranties ,expressed or implied, including ,but not limited to,
  10.     implied warranties of merchantability and fitness for a particular
  11.     purpose with respect to defects in the diskette and documentation, and
  12.     program license granted herein, in particular, and without limiting
  13.     operation of the program license with respect to any particular
  14.     application use or purpose.  In no event shall the authors be liable
  15.     for any loss of profit or any other commercial damage including but
  16.     not limited to special, incidental, consequential or other damages.
  17.  
  18.  
  19.     LICENSING AGREEMENT
  20.  
  21.     You may use this program for a 10 DAY TRIAL PERIOD.  Should you find
  22.     this program useful, you MUST register it; you will then be provided
  23.     with the latest releases of the VGACAD system see last section of this
  24.     manual).
  25.  
  26.     You can freely distribute copies of unmodified VGACAP and charge $10
  27.     max for distribution, in lieu of recognized Users Group guidelines
  28.     (e.g., Asso. of Shareware Professionals or NY Amateur Computer Club).
  29.  
  30.  
  31.     WHAT IS VGACAP ?
  32.  
  33.     VGACAP is a resident utility that captures pictures in
  34.  
  35.         MCGA 320x200x256
  36.          VGA 640x480x16
  37.         SVGA 640x480x256
  38.         SVGA 800x600x16
  39.         SVGA 800x600x256
  40.         SVGA 1KBx768x16
  41.             and
  42.         SVGA 1KBx768x256
  43.  
  44.     VGACAP will capture and "Bsave" 320x200x256 pictures; all others are
  45.     saved to *.RAW file files (ie., "RAW" pixel dumps).
  46.  
  47.  
  48.     WHAT IS VGAFIL ?
  49.  
  50.     VGAFIL is a conversion program for use in a batch file (*.BAT) or as an
  51.     interactive stand-alone program; BLD/PLT files are 320x200x256 screens,
  52.     all others are RAW/PLT files.  VGAFIL is designed to integrate directly
  53.     with VGACAD v2.0 (and up) and replace BLD2GIF and RAW2GIF.  Moreover,
  54.     VGAFIL converts and saves captured images to 32768-color TGA (Targa 16),
  55.     256-color BMP (Windows 3.0), PCX, GIF files or 16-color GIF files.
  56.     VGAFIL is also a utility to customize and configure VGACAP to take
  57.     advantage of specific SVGA chipset hardcoding for FAST screen captures.
  58.  
  59.  
  60.     VGACAP and VGAFIL can be viewed as a generic conversion utility system
  61.     since almost any MCGA/VGA/SVGA image from (320x200 to 1024x768) that can
  62.     be viewed, can be converted to/from GIF, PCX, BMP or TGA format !  If you
  63.     can view files using 'less popular formats', you can capture and convert
  64.     them like so ...
  65.  
  66.    'LESS POPULAR'
  67.     FILE FORMATS (input)
  68.  
  69.      EFS  \
  70.      WIPS  \
  71.      SFP    \
  72.      PIG     \
  73.      RAS      \ YOUR   -->  SVGA
  74.      ISF      / VIEWER --> SCREEN
  75.      PDA     /               |        CAPTURED      VGAFIL
  76.      DEGAS  /              VGACAP --> RAW FILES --> UTILITY
  77.      GEM   /                                           |
  78.      ETC  /                                            |
  79.                          'MORE POPULAR'
  80.                           FILE FORMATS (output)
  81.  
  82.                               GIF
  83.                               PCX
  84.                               BMP (Windows 3.0)
  85.                               TGA (Targa)
  86.  
  87.  
  88.  
  89.     REQUIREMENTS
  90.  
  91.     About 512KB of memory is required for VGAFIL, although it uses about 2/3
  92.     of that; it, also, requires that the BRUN41.exe runtime module be present
  93.     in your present path; this is explained later in this manual.  You MUST
  94.     have a VGA or MCGA adaptor (at least BIOS compatible) present and an
  95.     analog monitor to use VGACAP.  VGACAP uses about 4KB of RAM.  To use
  96.     the VGA 640x480x16 or ANY SVGA mode, you MUST have VGA or SVGA.
  97.  
  98.  
  99.     COMPATIBILITY
  100.  
  101.     The BRUN41.exe runtime module HATES 'Shadow RAM' (ie., putting your
  102.     VIDEO BIOS in low or high RAM); it 'hangs' (at least on our 386 SX).
  103.     If MVGAVU 'locks-up' at start-up then you have this problem too;
  104.     disable 'Shadow RAM' (eg., via CMOS set-up) and it should work.
  105.  
  106.     Trident TVGA card users that have the supposedly rare 'BR versions'
  107.     will notice that the bank switching will be erroneous.  We tried to
  108.     accomodate this version but ended up compromising the more popular
  109.     TVGA 8800 and 8900 versions <sorry>.   The Trident 1024x768x256 grabs
  110.     are not supported at this time since it uses a very peculiar, card
  111.     specific, bank switching methodology (ie., it conflicts with SVGA
  112.     display conventions); screen grabs are limited 800x600x256 or
  113.     1024x768x16, if available.
  114.  
  115.     ATI SVGA card users CANNOT capture 1024x768x16 screens if they are
  116.     trigerred via mode 65 (hex) since this is the old packed mode that
  117.     is inconsistent with SVGA 16-color display conventions.  ATI users
  118.     MUST view 1024x768x16 screens via mode 55 (hex), the planar mode,
  119.     to grab them.
  120.  
  121.     If you are having compatibility problems with VGACAP (particularly SVGA
  122.     bank switching) or VGAFIL encoding, please contact Lawrence Gozum
  123.     [73437,2372] via CompuServe's
  124.  
  125.                   E-Mail
  126.                 or
  127.                 PICs Forum
  128.  
  129.  
  130.  
  131.  
  132.     CONFIGURING VGACAP
  133.  
  134.     VGACAP, on default, is set for BIOS operations;  BIOS calls are 'generic'
  135.     and should work with most, if not all, SVGA cards.   However, BIOS calls
  136.     are slow.  By using the hardware configuration, VGACAP will capture
  137.     screens in 2-3 seconds compared to about 20-30 seconds for 800x600x256
  138.     screens (based on 28ms HD on 16 MHz 386sx).
  139.  
  140.     To configure VGACAP for your specific hardware type
  141.  
  142.                         VGAFIL -V <ret>
  143.                                or
  144.                         VGAFIL -C <ret>
  145.  
  146.     A menu will guide you.  Simply select the letter which corresponds to
  147.     your video card chipset.  Remember, when in doubt, return the setting
  148.     to BIOS operations.  BIOS operations does not guarantee that it will
  149.     work, generally, if your video board manufacturer took care in
  150.     writing its BIOS - it SHOULD work.  BIOS grabs are limited to a
  151.     maximum of 800x600x256/16 resolution, if available.
  152.  
  153.  
  154.     HOW TO USE VGACAP
  155.  
  156.     Run VGACAP before entering your painting/CAD or digitized picture
  157.     viewer.   Press <ALT-F4>, while viewing your picture in any paint/CAD
  158.     program and the screen and palette will be saved in your default drive
  159.     and directory.  If you are viewing your picture in MCGA/VGA 320x200x256
  160.     then it will be "Bsaved".  If you are NOT is MCGA/VGA 320x200x256 mode,
  161.     then VGACAP will assume you are in an SVGA mode !  Since 800x600x16,
  162.     1024x768x16 and 1024x768x256 modes cannot be reliably differentiated,
  163.     capturing screens in those modes require pressing different HOTKEYS.
  164.  
  165.     <alt-F4> is the HOTKEY for  MCGA 320x200x256
  166.                      VGA 640x480x16
  167.                     SVGA 640x480x256
  168.                        and
  169.                     SVGA 800x600x256
  170.  
  171.     <alt-F6>  is the HOTKEY for SVGA 800x600x16
  172.  
  173.     <alt-F7>  is the HOTKEY for SVGA 1KBx768x16
  174.  
  175.     <alt-F10> is the HOTKEY for SVGA 1KBx768x256
  176.  
  177.     You'll note that we tried to keep a 'pneumonic' device (ie., made it
  178.     easy to remember).
  179.  
  180.         <alt-F4>  '4' all the common modes
  181.  
  182.         <alt-F6>  for 800x600x16
  183.                   *   **
  184.  
  185.         <alt-F7>  for 1024x768x16
  186.                    *
  187.  
  188.         <alt-F10> for 1024x768x256
  189.                   **
  190.  
  191.     Note: Some applications (eg., Windows) will NOT allow "hotkeys" and
  192.       will not allow screen captures.
  193.  
  194.  
  195.     The first time you run the program it will save your screen and palette
  196.     to SCREEN00.BLD (.RAW) and SCREEN00.PLT respectively.  If there is an
  197.     existing SCREENxx.BLD (.RAW) or SCREENxx.PLT file, it will increment to
  198.     the next higher number.  You can use your favorite memory managers to
  199.     remove this TSR or reboot to release it from memory.
  200.  
  201.     Note: Other programs, such as VGTIZE (Oculus-20 video grabbing
  202.       software) alters the video mode to the extent that garbage
  203.       results in files.
  204.  
  205.     If you are viewing in MCGA 320x200x256 then a SCREENxx.BLD and *.PLT
  206.     file is saved.  SCREENxx.RAW files are saved in all other cases; the
  207.     "Bload" header is not included and a "RAW" contiguous pixel dump is
  208.     implemented.  If you wish, you can easily design your own utilities to
  209.     read and process these "RAW" pixel dumps; they are simple contiguous
  210.     pixel dumps (eg. 307,200 bytes = 640 x 480 pixels for VGA 640x480x16
  211.     or SVGA 640x480x256 screens).  The *.PLT files remain the same.
  212.  
  213.     Note: When in DOS or using a picture viewer or application which
  214.       requires a keypress to continue, it is necessary to hit
  215.       another key after hitting the 'HOTKEY'.
  216.  
  217.  
  218.     LOADING/CONVERTING SCREEN GRABS WITH VGAFIL
  219.  
  220.     If you type "VGAFIL <ret>", then you can select any filename by moving a
  221.     highlighted bar (with the arrow keys) and pressing the <return> key.
  222.     Pressing <Spc> allows you to select a different PATH, while <Esc> exits.
  223.  
  224.     A matching *.PLT file MUST exist or an error message will result.
  225.     A *.GIF or *.PCX file is created with the corresponding name.
  226.     GIF/PCX FILES WITH THE SAME NAME WILL BE OVERWRITTEN !
  227.  
  228.     On default, VGAFIL selects RAW/PLT files.  BLD/PLT files can be selected
  229.     by using the "-B" option.
  230.  
  231.                         VGAFIL -B <ret>
  232.  
  233.     On default, all captured screens are converted to GIF (87a) files.
  234.     To convert screens to 256-color PCX files, use the "-P" option.
  235.  
  236.                         VGAFIL -P <ret>
  237.  
  238.     To convert screens to 256-color BMP files for Windows 3.0, use the
  239.     "-W" option (for uncompressed Windows 3.0 "Wallpaper").
  240.  
  241.                         VGAFIL -W <ret>
  242.  
  243.     To convert screens to 32768-color TGA files for XGA, Hercules GS,
  244.     Targa cards (and other "high-end clones"), use the "-T" option (for
  245.     uncompressed Targa-16 format").
  246.  
  247.             VGAFIL -T <ret>
  248.  
  249.     To convert screens to 16-color GIF files, use the "-H" (ie., "Hex)
  250.     option.  USE THIS OPTION ONLY WHEN YOU ARE SURE YOU ARE ENCODING
  251.     16-COLOR IMAGE GRABS OR THE PROGRAM WILL HANG !!!
  252.  
  253.             VGAFIL -H <ret>
  254.  
  255.  
  256.  
  257.     COMMAND LINE AND BATCH FILES
  258.  
  259.     VGAFIL can be used in batch (*.BAT) files for multiple conversions.
  260.     Simply type "VGAFIL [filename] " with no extension (path optional) for
  261.     every file you want to convert in your batch file;  you can also use
  262.     this method if you want to convert a specific file from DOS.
  263.  
  264.          Examples:   VGAFIL screen00
  265.                      VGAFIL -B screen00
  266.                      VGAFIL \capture\screen99
  267.                      VGAFIL -B \capture\screen99
  268.                      VGAFIL -P \capture\screen99
  269.                      VGAFIL -W \capture\screen99
  270.              VGAFIL -T \capture\screen99
  271.              VGAFIL -H \capture\screen99
  272.  
  273.     VGAFIL will automatically search for the RAW/PLT files or BLD/PLT files.
  274.     If no files are found or matching *.PLT file is missing, then an error
  275.     will result; the matching PLT files MUST be in the same drive/directory
  276.     or default drive/directory.
  277.  
  278.  
  279.     TEMP, MVGASCRN, NYBLSCRN, AND USERSCRN FILES
  280.  
  281.     TEMPorary files are used by VGACAD, SQZGIF, GIFPUB, ... (and other
  282.     utilities we may release).  When TEMP files are detected by VGAFIL, you
  283.     will be prompted to convert it.  If you acknowledge the prompt, you will
  284.     be presented with two options: 16-color encoding and forcing 1:1 Aspect
  285.     Ratio (these options will work ONLY for GIF files).
  286.  
  287.     MVGASCRN files are essentially similar to *.RAW files.  USERSCRN files
  288.     are created with VGACAD (v2.0 and up) and SQZGIF (v2.1 and up); these
  289.     files have unusual screen sizes and have additional support files like
  290.     TEMP files.
  291.  
  292.     NYBLSCRN (a "nybble" is half a byte or 4 bits or 16 colors) files have
  293.     special meaning for VGAFIL.  If VGAFIL detects this filename, it
  294.     immediately converts the file in TRUE 16-color format; this applies
  295.     only to GIF files.
  296.  
  297.  
  298.     16-COLOR MODE GRAB & CONVERSION
  299.  
  300.     All VGA 640x480x16 screens will be grabbed regardless of the hardcoded
  301.     hardware setting of VGACAP.
  302.  
  303.     SVGA 800x600x16 screens can also be captured in two ways:
  304.  
  305.     1) With the <alt-F4> 'hotkey', if and only if the BIOS configuration
  306.        is used, since your video card will determine and execute the
  307.        appropriate routine, albeit much slower.
  308.  
  309.     2) With the <alt-F6> 'hotkey', using FAST direct memory read
  310.        routines (actually more dependable than BIOS in some respects).
  311.  
  312.     16-color images will be saved as 256-color files with the remaining
  313.     240 colors unused UNLESS
  314.  
  315.         you rename the captured files to NYBLSCRN.*
  316.         and use GIF encoding (default)
  317.  
  318.         or
  319.  
  320.         use the "-H" option.
  321.  
  322.  
  323.     Note: Using the "-P","-W" or "-T" option will encode a 16-color .PCX,
  324.           .BMP or .TGA file BUT it will be encoded and viewable as a
  325.           256-color or 32768-color image with remaining colors unused
  326.           (ie., you can still view the 16-color PCX, BMP or TGA file, BUT
  327.           only in 256-color or greater mode).
  328.        
  329.           256-color PCX compression of 16-color images is VERY poor (it is
  330.           not designed that way).  It would be better to encode 16-color
  331.           GIF files with VGAFIL then use another program (eg., VPIC) to
  332.           convert the 16-color GIF to a 16-color PCX file.
  333.        
  334.  
  335.  
  336.     THE CHAINED VGACAD ENVIRONMENT
  337.  
  338.     BRUN41.exe is a runtime module distributed under licence with Microsoft;
  339.     it can be distributed and used ONLY in connection with this program.
  340.     You can place it in any drive/directory as long as your PATH has access
  341.     to it.  VGACAD v2.0 and up integrates VGAFIL into its chained
  342.     environment; it is actually a module of VGACAD (v2.0 and up).
  343.  
  344.     The advantage of using the BRUN41.exe is an integrated system of
  345.     utilities and "sub-programs".  New releases will be modified to support
  346.     the "chained environment", with VGACAD as the integrator.  Only one copy
  347.     of BRUN41.exe is required.
  348.  
  349.  
  350.     USING SVGA SCREEN GRABS IN VGACAD
  351.  
  352.     If you capture a 640x480x256 or 800x600x256 screen for direct editing in
  353.     VGACAD then:
  354.  
  355.     (1)  from the VSCRN Menu, create a blank 640x480 or 800x600 Virtual
  356.          Screen (whichever corresponds to captured screen);
  357.  
  358.     (2)  exit VGACAD and DO NOT DELETE the TEMP files;
  359.  
  360.     (3)  overwrite TEMP.RAW and TEMP.PLT with the selected SCREENxx.RAW
  361.          and SCREENxx.PLT files; for example, at DOS prompt type
  362.  
  363.                         "COPY screen00.* temp.*" <ret>
  364.  
  365.     (4)  run VGACAD and load TEMP.PLT at the Files Menu;
  366.  
  367.     (5)  click the VSCRN box; at the VSCRN Menu, click iSCR vDSK then OK;
  368.          you see the captured 640x480x256 or 800x600x256 image as the new
  369.          Virtual Screen.
  370.  
  371.  
  372.     REGISTRATION
  373.  
  374.     REGISTRATION OF VGACAP IS BASED ON 'PERSONAL USAGE'.  CORPORATE OR
  375.     ORGANIZATIONAL USERS *MUST* REGISTER ALL COPIES USED ON AN INDIVIDUAL
  376.     BASIS; A SPECIFIC PERSON (NAME) MUST BE EXPLICITLY ASSIGNED TO EACH
  377.     REGISTRANT WHO WILL BE PROVIDED WITH A CORRESPONDING REGISTER.OVL FILE
  378.     TO INDICATE REGISTERED USAGE.  REGISTRATION GRANTS A SPECIFIC PERSON
  379.     (NOT A JURIDICAL PERSON OR CORPORATE ENTITY) THE RIGHT TO 'USE'
  380.     VGACAP OR VGAFIL.
  381.  
  382.     ┌───────────────────────────────────────────────────────────────────┐
  383.     │ ALTHOUGH WE WILL TRY TO RESPOND TO YOUR REGISTRATION IN 2-3 WEEKS,│
  384.     │ PLEASE ALLOW UP TO 4-6 WEEKS DELAY TO PROCESS YOUR REGISTRATION.  │
  385.     └───────────────────────────────────────────────────────────────────┘
  386.  
  387.     As token of our appreciation (i.e., to registered users), we will send
  388.     you the the latest version of the VGACAD system; many of the programs
  389.     listed below do not require a graphics card.
  390.  
  391.  
  392.     GIFPUB - converts 256 color GIF/PCX files to B&W images desktop
  393.     publishing (DTP) as .PCX (Ventura, First Publisher, Publisher's
  394.     Paintbrush, WP, Pagemaker).  Variable sizing/contrast/brightness.
  395.     Includes printing on IBM/Epson, HP Laser and compatible printers.
  396.     Variable sizes. 8 pics/page and/or  Single/Double Pass printing on
  397.     dot matrix printers. Preview in CGA/HGC/EGA/VGA/EEGA/SVGA. Histogram-
  398.     equalization.  No graphics card required.
  399.  
  400.     GIFBIT - converts B&W PCX files (e.g., scanner output to 32KBx32KB !)
  401.     to grey shades for VGACAD image processing, GIFPUB redithering or
  402.     printing, or VGA2EGA conversion - it edits those "scan line jitters".
  403.     Viewing modes in MCGA/VGA/SVGA.  No graphics card required.
  404.  
  405.     SQZGIF/EGA2VGA - converts LARGE GIF/PCX pics (to 2KBx2KBx256) to
  406.     several sizes and video modes using "color averaging" to blend/smooth
  407.     "jaggies" or fast interpolation.  Variable sizing.  Also, converts
  408.     GIFs (16 colors and below) and creates up to 256 new colors; outputs
  409.     directly to GIFPUB, GIFDOT, VGACAD, MVGAVU, VGA2CGA or VGA2EGA.
  410.     No graphics card required.
  411.  
  412.     GIFHEX (formerly VGA2EGA) - converts 256-color pictures to 16-color
  413.     EGA or VGA .  Error-distributed dithering.  User support to 1024x768.
  414.     Variable sizing/RGBICMY/contrast.  EGA/MCGA/VGA required.
  415.  
  416.     MVGAVU - EGA/MCGA/EEGA/VGA/SVGA viewer for GIF, TGA (Targa 16/24/32),
  417.     BMP (Windows 3.0) and BLD/PLT files.  A unique SVGA 32K-color rendering
  418.     is used in viewing TGA files in 16/256-color modes.  4096 file selection.
  419.     Smart slideshows - picks best mode.  320x400x256 and 360x480x256 VGA
  420.     modes.  Full GIF 89a support. RGB/Color/Contrast/Brightness and Monitor
  421.     adjust. AutoSize/AutoCenter/AutoAspect. 1:1, 5:6 and TGA aspect ratio
  422.     correction.  EGA/MCGA/VGA required.
  423.  
  424.     VGACAD - extensive paint/image processing program for VGA/MCGA users
  425.     (edit GIFs up to 32KBx32KBx256 !!!); airbrushes, color and grey image
  426.     processing functions (smoothing, noise removal, shading, contrast
  427.     stretching, edge detection, ...), splines, Cut&Paste, variable sizing,
  428.     256-color gradient/pattern fills, MORE !  Full screen SuperVGA editing
  429.     and image processing function to 1024x768x256.   360x480x256 support.
  430.     MCGA/VGA required.
  431.   
  432.     VGA2CGA - converts 256 color GIFs to CGA!  See "405" colors in an
  433.     unsupported 160x100x16 CGA mode.  CGA/EGA/MCGA/VGA required.
  434.  
  435.     MAC2GIF - converts .MAC ("readmac") pictures to 5-16 grey shades or
  436.     color and saves to .GIF or BLD/PLT file.  EGA/MCGA/VGA required.
  437.  
  438.  
  439.     WHAT'S NEXT ?
  440.  
  441.     Aside from enhancing existing releases with greater capabilities (e.g.,
  442.     expanded memory, virtual screen, SVGA functions, other graphics
  443.     formats), we are developing VGACBT (Computer-Based Training program)
  444.     and MANNEQUIN for Advertising/Fashion Design or creating your own
  445.     artistic nudes.  We will try to develop and integrate more image
  446.     processing functions for all our applications; if you have any image
  447.     processing functions you would like to see, please let us know.
  448.  
  449.     In the short term, we are developing RGBLAB.  This is a color reduction
  450.     utility to 'downsize' 24-bit or 16 Million-color pictures to 256-colors.
  451.     RAW red, green and blue files, TIFF (*.TIF), TARGA (*.TGA) and Windows
  452.     3.0 (*.BMP) files will be the main input sources.  IDTVGA dithering will
  453.     play a key role in previewing or rendering 24-bit images in SVGA
  454.     256-color modes.
  455.  
  456.     Support maverick authors like us and we will continue developing
  457.     products like nothing seen commercially - otherwise they will simply
  458.     "DIE" from lack of support !  Compare the cost/benefit ratio of any of
  459.     our products with commercial products.  You, and you alone, determine
  460.     whether it will be worthwhile to continue developing.  Support the
  461.     User-Supported (Shareware) concept.  Register your Shareware copies.
  462.     To register, send the registration form and check or money order payable
  463.     in USD to:
  464.  
  465.                                Dr. Marvin Gozum
  466.                   2 Independence Place #1105, 6th & Locust
  467.                             Philadelphia, PA 19106
  468.  
  469.  
  470.  
  471.     ───────────────────────────────────────────────────────
  472.     Graphics Interchange Format and GIF are trademarks (tm)
  473.     of CompuServe Inc. an H&R Block Company.
  474.  
  475.